# Geografia — mapy do ćwiczeń (25.09.2026)

Źródło: Natural Earth 50m (domena publiczna) — `../src/ne_50m_*.geojson`; nazwy polskie: pole `name_pl` NE + `nazwy-pl.json` (rzeki, regiony fizyczne, stolice, morza — słownik własny). Flagi: Wikimedia Commons (`flagi/kod/<ISO>.svg`, 236 państw i terytoriów; 229 PD, 5 CC0, 1 OGL, 1 CC BY 2.5 — `flagi/flagi-katalog.json`).

| Plik | Co |
|---|---|
| `generator-swiat.py` | generuje wszystko poniżej; `python3 generator-swiat.py azja` — jeden kontynent |
| `<kont>-panstwa.svg` | kontury państw: `path.panstwo[data-kod][data-nazwa][data-stolica]`, sąsiedzi spoza kontynentu jako `.sasiad`, etykiety `.etykieta` (ukrywane atrybutem `data-ukryj-etykiety` na `<svg>`) |
| `<kont>-fizyczna.svg` | ląd + `.gory/.wyzyna/.pustynia/.nizina` (regiony NE z polską nazwą), `.jezioro`, `.rzeka` (scalerank ≤ 5), etykiety mórz/oceanów; każdy obiekt `.obiekt[data-rodzaj][data-nazwa]` |
| `<kont>-dane.json` | państwa (kod, nazwa PL/EN, stolica, ludność, region, flaga, x/y) + obiekty fizyczne (rodzaj, nazwa, x/y) |
| `polska-*.svg` | mapa Polski z wcześniejszej nocy (województwa, rzeki, miasta, ślepa) |
| `flagi/` | SVG z Commons + `flagi-katalog.json`; w aplikacji małe jako SVG, duże (herby) jako PNG 200 px |

Kontynenty: azja, europa, afryka, ameryka-polnocna, ameryka-poludniowa, australia-oceania, swiat. Odwzorowanie: walcowe równoodległościowe (skala x = cos szer. środkowej) — szkolne, nie nawigacyjne.

**Trening w aplikacji (TEST):** `plannaszkole-test.pages.dev/mapy/` — tryby: wskaż państwo · podaj stolicę · co to za państwo · czyja to flaga · mapa fizyczna: wskaż / nazwij. Wynik lokalny (bez zapisu) — docelowo typ ćwiczenia T1 w silniku z zapisem do SRS i dziennika błędów.

Do zrobienia: nazwy PL dla mniejszych rzek/regionów (słownik), etykiety bez nakładania (algorytm rozsuwania), mapy tematyczne (klimat, ludność) — osobne źródła.

## Uzupełnienie 25.09.2026 (przedpołudnie)
- `generator-polska.py` → `polska-panstwa.svg` (16 województw, miasta), `polska-fizyczna.svg` (rzeki i jeziora z NE 10 m + ręcznie: krainy wg pasów rzeźby, 23 parki narodowe, 8 szczytów, zatoki, mierzeje, wyspy, skrajne punkty), `polska-dane.json`.
- `generator-panstwo.py` → mapy administracyjne 13 państw (`<kod>-regiony-panstwa.svg/-dane.json`): DE, US, UA, CZ, SK, CA, AU, IT, ES, FR, BR, CN, IN; nazwy PL w słowniku `PL` w skrypcie.
- `generator-kontynenty.py` → `kontynenty-panstwa.svg` (7 kontynentów, 5 oceanów, równik, zwrotniki, koła podbiegunowe, południk 0° i 180°, bieguny) — kl. 5; tryb „Współrzędne geograficzne” (kl. 6) w trenerze korzysta z tej mapy (20 miast).
- `panstwa-swiat.json` — 194 państwa (ONZ + Watykan, Palestyna, Kosowo, Tajwan): nazwa PL/EN, stolica, ludność, kontynent, region, plik flagi.
- `rekordy.json` (w aplikacji `public/mapy/`) — ok. 100 pytań „najwyższy / najdłuższy / największy” dla Polski, kontynentów i świata.
- `karty-kl8.json` — dwie karty tematów (Azja; Afryka i Ameryki) w formacie tabeli `karta_tematu` (sekcje markdown + pytania z odpowiedziami).
- Źródła NE 10 m w `../src/`: admin_0, admin_1, rivers (+ rivers_europe), lakes (+ lakes_europe), populated_places, geography_regions_polys/points/elevation_points, glaciated_areas, geographic_lines, parks_and_protected_lands.

## Aktualizacja 25.09.2026 (mapy v3)
- **SVG map i flagi są na CDN Bunny** (`https://plannaszkole.b-cdn.net/mapy/…`, `…/mapy/flagi/…`); w paczce aplikacji zostają tylko `*-dane.json`, `rekordy.json`, `panstwa-swiat.json` i `index.html`. Po regeneracji map trzeba wgrać SVG na CDN (funkcja `media` → `wgraj_wiele` z tymczasowego wdrożenia TEST albo z dozwolonego hosta).
- `punkty-swiat.json` — 118 punktów specjalnych (zabytki i cuda cywilizacji, cieśniny, kanały, rowy oceaniczne, wulkany, wodospady, lodowce, stacje polarne, depresje, przylądki skrajne); generator dokłada je do map fizycznych (klasa `obiekt pkt <rodzaj>`), pomija duplikaty z NE.
- `kanon-szkolny.json` — frazy kanonu szkolnego; każdy obiekt w `*-dane.json` ma `waga`: 1 = kanon (o to pytają), 2 = ważne (morza, szczyty, punkty specjalne, rzeki, duże regiony), 3 = reszta. Trener: „zakres: szkolny / rozszerzony / wszystko".
- `*-dane.json` → pole `tlo` = położenie pełnego rastra świata (równoodległościowy walcowy) w układzie mapy; trener wstawia `<image>` z CDN: `mapy/tlo/topograficzna-3840.jpg` (NASA SRTM ramp, domena publiczna), `mapy/tlo/satelitarna-3840.jpg` (NASA Blue Marble, domena publiczna; też `satelitarna-8192.jpg`). Dla Polski raster świata jest za mało dokładny (`tlo.w` > 8000 → opcja ukryta) — potrzebne osobne źródło.
- Źródła NE (`bank/src/*.geojson`, ok. 100 MB) **nie są w repozytorium** (`.gitignore`) — do pobrania ponownie z Natural Earth (domena publiczna) przy regeneracji.